<?php
/**
 * licenses : MIT
 * creatTime: 2020/5/15
 * author : weblinuxgame
 * filename: PostApi.php
 */

namespace App\Api\Modules\Posts;

use Illuminate\Http\Request;
use Illuminate\Http\Response;
use OpenApi\Annotations as OA;

/**
 * @OA\Tag(
 *    name="Post",
 *    description="## 文章,游记前端-操作接口",
 *  )
 */

/**
 * Interface PostUserActionApi
 * @package App\Api\Modules\Posts
 */
interface PostUserActionApi
{
    /**
     * 收藏文章
     * @param Request $request
     * @return Response
     */
    public function collect(Request $request): Response;

    /**
     * 移除收藏文章
     * @param Request $request
     * @return Response
     */
    public function remove(Request $request): Response;

    /**
     * 文章点赞
     * @param Request $request
     * @return Response
     */
    public function agreeUp(Request $request): Response;

    /**
     * 踩文章
     * @param Request $request
     * @return Response
     */
    public function agreeDown(Request $request): Response;

    /**
     * 获取分享文章信息结构
     * @param Request $request
     * @return Response
     */
    public function share(Request $request): Response;

}
